home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / mint / mntlb20 / readme
Text File  |  1992-05-18  |  4KB  |  77 lines
  1.  
  2. *NOTE*: to compile the library you will need the header files in mntinc20.zoo
  3.  
  4. New features in this patchlevel: most notable is the (limited) support
  5. for Sozobon 2.0, courtesy of Dave Gymer. See the "lib\sozobon" subdirectory,
  6. and note that all Sozobon stuff is very experimental and quite probably
  7. needs more work; caveat emptor. Also note that Dave was using GNU Make
  8. and a gcc compiled sozobon compiler, so the supplied makefile make need
  9. tweaking with the "native" sozobon utilities. (Scott Bigham has since
  10. sent a makefile that should work with the Sozobon 1.33i make).
  11.  
  12. ============================================================================
  13.  
  14. Here is mintlib, a library for gcc and Sozobon which produces programs usable
  15. under either MiNT or TOS (of course, some features, e.g. pipe(), are only
  16. available under MiNT). This version has been reasonably well tested under both
  17. TOS and MiNT, and with 16 and 32 bit integers, but no doubt bugs remain. Please
  18. report any that you find.
  19.  
  20. There are no docs ("Use the Source, Luke"), but most of the library should
  21. be pretty self-explanatory. MiNT specific features are active when the
  22. external variable __mint is non-zero; this variable is set automatically
  23. by the startup code in main.c. Some things to watch out for:
  24.  
  25. (1) MiNT has a blocking fork(), i.e. the parent waits for the child to
  26.     relinquish its address space rather than continuing in parallel.
  27. (2) Using the spawn functions instead of fork/exec means that your programs
  28.     will work under TOS as well as under MiNT. vfork() also works under
  29.     TOS now, so vfork/exec is another viable alternative.
  30. (3) The longjmp() code has a call to Psigreturn() embedded in it; this means
  31.     that most signal handlers will work without changes, but in some very
  32.     bizarre circumstances this could cause a problem (if the sig handler
  33.     longjmps *within* itself, and then returns, for example).
  34. (4) Under TOS, all terminal reads are assumed to come from the console
  35. (5) You'll note that there is only minimal support for UNIXMODE;
  36.     this is because MiNT 0.9 supports symlinks in the kernel.
  37. (6) A function call, tfork(), is provided to start a new thread of
  38.     execution in the same address space. The declaration is
  39.     int tfork( int (*func)(), long arg ).
  40.     A new process is started, which executes concurrently with the parent
  41.     process and in the same address space (but a different stack).
  42.     The child begins at the address in func, with the stack set up as though
  43.     the call (*func)(arg) was made (in fact, this call *is* made!).
  44.     The child will exit when func returns, with the exit status being the
  45.     return code of func. The parent continues to execute concurrently;
  46.     in the parent, the value returned from tfork() is the process id of the
  47.     child.
  48. (7) The library is not set up to handle multiple threads of execution in the
  49.     same address space, so you'll have to provide semaphores for critical
  50.     library calls (e.g. malloc) yourself if you have multiple threads.
  51.  
  52. NOTE: If you already have a gcc library, make sure that you do *not* use
  53. its header files to build the mint library. Some headers (signal.h and
  54. ioctl.h) have changed significantly, and are no longer compatible. The
  55. environment variable GNUINC should point to the include directory obtained
  56. from this zoo file whenever you make any MiNT related stuff. (I've completely
  57. replaced my TOS library with this one, because it can produce TOS programs
  58. too.)
  59. Note to the note: recent versions of the gcc library have header files that
  60. are compatible with mntlib. I can't vouch for the compatibility 100% (and you
  61. definitely need a *very* recent version of the include files to get complete
  62. compatibility with mntlib20).
  63.  
  64.  
  65. The library is based on the gcc library that Jwahar Bammi and I put together.
  66. Lots of people have contributed to it, including (but not limited to):
  67.  
  68. Adrian Ashley, Jwahar Bammi, Scott Bigham, Kai-Uwe Bloem, John R. Dunning,
  69. Doug Gwyn, Dave Gymer, Alan Hourihane, Alex Kiernan, Allan Pratt, Arnold D. Robbins,
  70. Edgar Roeder, Rich Salz, Dale Schumacher, Eric Smith, Henry Spencer, and Stephen Usher.
  71.  
  72. I've hacked on things quite a bit, so if they're broken don't blame the
  73. original authors, blame me.
  74.  
  75. Eric R. Smith
  76. eric.smith@uwo.ca
  77.